home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d2 / xdir302.arc / XDIR.DOC < prev    next >
Text File  |  1990-10-14  |  44KB  |  1,205 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                                         
  13.                                XDIR USER'S GUIDE
  14.                                  VERSION 3.02
  15.                                        
  16.                                 September 1990
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.                                   XD SYSTEMS
  54.                                1014 SHIPMAN LANE
  55.                                 MCLEAN, VA 22101
  56.  
  57.      A. BACKGROUND............................................  1
  58.  
  59.      B. REGARDING REGISTRATION................................  2
  60.  
  61.      C. XDIR MODES............................................  2
  62.           1. Help mode........................................  2
  63.           2. Directory Mode...................................  2
  64.           3. Edit mode........................................  3
  65.           4. Copy mode........................................  4
  66.           5. Move mode........................................  4
  67.           6. Kill Mode........................................  5
  68.           7. Run Mode.........................................  5
  69.  
  70.      D. DISPLAY OPTIONS.......................................  6
  71.           1. PICK Option .....................................  6
  72.           2. Alternative Display Formats......................  6
  73.                a. Normal Display..............................  7
  74.                b. Full Display................................  7
  75.                c. Usage Display...............................  7
  76.                d. Wide Display................................  8
  77.           3. Sort Switch......................................  8
  78.           4. Quick Write Display Toggle.......................  8
  79.           5. Display of Hidden Files..........................  9
  80.           
  81.      E. INSTALLATION.........................................   9
  82.           1. General Use of XDIR.............................   9
  83.           2. Conversion from Previous Versions of XDIR.......   9
  84.           3. Customizing XDIR Features.......................  10
  85.      
  86.      F. Additional Utilities for use with XDIR...............  10
  87.           1. File Use Monitoring with XDCOUNT and XDUPDATE...  10
  88.                a. Installing XDCOUNT.........................  10
  89.                b. Use of XDUPDATE............................  11
  90.                c. Use of XDUPDATE to Clear Usage Data........  12
  91.           2. XDZIP and XDUNZIP ..............................  12
  92.                a.  XDZIP USAGE...............................  12
  93.                b. XDUNZIP USAGE..............................  13
  94.           
  95.      G. FILES SUPPLIED.......................................  14
  96.      
  97.      H. ASSOCIATION OF SHAREWARE PROFESSIONALS...............  15
  98.      
  99.      I. XDIR VERSION HISTORY.................................  16
  100.  
  101.      SOFTWARE REGISTRATION FORM AND ORDER....................  18
  102.  
  103.                          LIMITED WARRANTY
  104.  
  105.      XD Systems warrants the physical diskette enclosed herein to be 
  106. free of defects in materials and workmanship for a period of 60 days 
  107. from the date of purchase.  In the event of notification within the 
  108. warranty period of defects in material or workmanship, XD Systems will 
  109. replace the defective diskette.
  110.  
  111.      XD Systems specifically disclaims all other warranties, express 
  112. or implied, including but not limited to implied warranties of 
  113. merchantability and fitness for a particular purpose.  In no event 
  114. shall XD Systems be liable for any loss of profit or any other 
  115. commercial damage, including but not limited to special, incidental, 
  116. consequential or other damages arising out of the use, the result of 
  117. use, or inability to use this product.
  118.  
  119.      This program is produced by a member of the Association of 
  120. Shareware Professionals (ASP).  ASP wants to make sure that the 
  121. shareware principle works for you.  If you are unable to resolve a 
  122. shareware-related problem with an ASP member by contacting the member 
  123. directly, ASP may be able to help.  The ASP Ombudsman can help you 
  124. resolve a dispute or problem with an ASP member, but does not provide 
  125. technical support for members' products.  Please write to the ASP 
  126. Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send a Compuserve 
  127. message via easyplex to ASP Ombudsman 70007,3536
  128.  
  129.      XDZIP/XDUNZIP and all the files and documentation distributed 
  130. with it are copyright 1990 by Iram J. Weinstein.  All rights reserved.
  131.  
  132.                           XDIR User's Guide
  133.                             Version 3.0
  134.                                  
  135.                          Copyright (C) 1990
  136.                             I.J. Weinstein
  137.  
  138.  
  139.      A. BACKGROUND
  140.                
  141.      I've tried a number of the available DOS Shell programs and Hard 
  142. Disk Managers and am still left with two frustrations. DOS restricts 
  143. file names to 11 characters, not enough in my opinion.  Also, I'm 
  144. always short of space on my hard disk. It's full of files that I 
  145. probably don't need. It would be nice to know how often I use 
  146. SUPERPRG.EXE,  and what is it anyway?
  147.  
  148.      XDIR is my solution to this frustration. XDIR is a replacement 
  149. for the DOS commands DIR and COPY. It allows you to add your own 
  150. comments to be displayed along with the normal DOS directory. You 
  151. won't have to remember what MPDPROG.MEM was all about. The directory 
  152. will remind you with a display like:
  153.  
  154.      MPDPROG MEM  2620 01-17-87  2:19p  Maxon Paper Div. Progress Report
  155.  
  156. XDIR allows you to edit these comments freely. You can copy or move 
  157. files between directories or to another disk, and the comment text 
  158. will automatically go right with it.
  159.  
  160.      XDIR has seven modes: Help, Directory, Edit, Copy, Kill, Move and 
  161. Run. These modes are selected from the command line, e.g., XDIR /e, 
  162. and are explained in Section C.
  163.  
  164.      In addition, XDIR has a number of display options that can be 
  165. selected as well. Options include: Pick, Sort, and alternate display 
  166. modes.  These options are explained in Section D.
  167.  
  168.      Additional utilities provided to registered users of XDIR include 
  169. XDCOUNT and XDUPDATE, which monitor file usage on your hard disk and 
  170. add information to the XDIR display on the number of times that each 
  171. file has been used and the date of the last use.  Also provided are 
  172. XDZIP and XDUNZIP, which let you automatically save the XDIR comments 
  173. when you ZIP files and restore them when you UNZIP.  Use of these 
  174. utilities is described in Section F.
  175.  
  176.  
  177.    B. REGARDING REGISTRATION
  178.  
  179.      XDIR is distributed under the Shareware concept. The program and 
  180. its associated documentation are the copyrighted property of the 
  181. author. Non-commercial users are granted the right to use copy and 
  182. share XDIR with the following conditions:
  183.  
  184.      Shareware distributors and Users Groups may charge a nominal fee 
  185. for copying and distributing this program and Bulletin Board Systems 
  186.  
  187.  
  188.  
  189.  
  190.  
  191.                                  -1-
  192.  
  193. may likewise carry it. Any distribution of XDIR must include without 
  194. alteration only the files listed in Section G of this documentation. 
  195. Permission is also given for electronic distribution of archived 
  196. versions of these files on electronic bulletin boards. 
  197.  
  198.      XDIR is Shareware. The law requires that if you use this program, 
  199. you must pay for it. So, if you find XDIR useful, please register your 
  200. use with the author. The registration fee is $25.  Registered users 
  201. will be notified of upgrades to XDIR as they are released, and will 
  202. receive a printed copy of this manual. Online help is available 
  203. through CompuServe, by EasyPlex. Sorry, but online help is available 
  204. ONLY to registered users. Help is also available by mail. I will try 
  205. to answer all letters within 48 hours. Non-registered users must 
  206. include a SASE for a reply. The degree of help available to 
  207. non-registered users is purely discretionary. Registrations and 
  208. inquiries should be sent to:
  209.  
  210.                Iram J. Weinstein 
  211.                XD Systems
  212.                1014 Shipman Lane 
  213.                McLean, VA 22101
  214.                Voice (703) 821-3215 
  215.                CIS 70741,3711
  216.  
  217.      A registration form is included at the end of this manual.
  218.  
  219.      Commercial use of XDIR without payment of the registration fee is 
  220. prohibited. Site licenses are available for users with multiple 
  221. machines. Please contact me for information.
  222.  
  223.  
  224.    C. XDIR MODES
  225.  
  226.      1. Help mode
  227.  
  228.                               XDIR /?
  229.  
  230.    Displays a series of help screens describing the XDIR modes.  If 
  231. you can't wait to use XDIR, try this for a quick and handy tutorial.
  232.  
  233.      2. Directory Mode
  234.  
  235.         XDIR [/d] [d:][path][filename][.ext] [> outputfile]
  236.  
  237.    Displays the commented directory. This is the default option, so 
  238. the option switch /d can be left off. You can specify the directory 
  239. you wish to view just as with DIR, including the wildcard features '?' 
  240. and '*'.  XDIR shows only a screen at a time. Pressing Esc will 
  241. terminate the directory display. PgDn will produce the next screen of 
  242. directory entries. You can scroll the display up and down through the 
  243. directory with PgUp and PgDn. If the number of files in the display 
  244. make up less than one full screen, the display will scroll onto the 
  245. screen, just like the DOS display. This facilitates use of XDIR to 
  246. display file choices in batch files. In all other situations, XDIR 
  247.  
  248.                                  
  249.  
  250.  
  251.  
  252.                                  -2-
  253.  
  254. will clear the screen and start the display from the top of the 
  255. screen.
  256.  
  257.      Output redirection to the printer or a disk file is allowed in 
  258. this mode. For example, you might print the directory of all of your 
  259. memo files to your printer with:
  260.  
  261.                           XDIR *.mem >prn
  262.  
  263.  
  264.      3. Edit mode
  265.  
  266.                 XDIR /e [d:][path][filename][.ext]
  267.  
  268.      This mode allows you to add and modify the directory comments, 
  269. which are then stored in the file XDIR.CMT. The * and ? wildcard 
  270. features can be used. The comment field is 65 characters long and can 
  271. contain any information you desire. The text editor provided is very 
  272. simple, allowing the usual motion around the comment fields with the 
  273. cursor keys. You can scroll the display up and down through the 
  274. directory with PgUp and PgDn.  Ctrl-PgUp will display the first screen 
  275. of the directory and Ctrl-PgDn will display the last screen. Home and 
  276. End move the cursor to the beginning and end of the current comment 
  277. field.  Ctrl-Home will move the cursor to the first directory entry on 
  278. the screen and Ctrl-End will move it to the last. The Del BackSpace 
  279. keys are active and work normally. You can toggle in and out of Insert 
  280. mode with the Ins key. Alt-Del erases the entire comment line.
  281.  
  282.      When you write your Comment lines, you should remember that one 
  283. of XDIR's display modes shows only the first 38 characters of the 
  284. comment in order to be able to also display the usual DOS file 
  285. information. If you plan ahead, you can make this first part convey 
  286. the most essential part of your comment.
  287.  
  288.      When you leave XDIR in this mode by pressing Esc, XDIR sorts the 
  289. comment file and writes it out to disk. This will take a noticeable 
  290. time if the directory has many entries.
  291.  
  292.      The XDIR.CMT file can also be freely edited in any editor that 
  293. produces an ASCII file. You must pay attention to the following 
  294. format:
  295.  
  296.    -Column--Field -
  297. Line 1
  298.    1-12        XDIR Ver 3.0
  299.  
  300. All other lines
  301.    1-8    File Name
  302.    9      Blank
  303.    10-12  File Extension
  304.    13     Blank
  305.    14-18  Number of Uses
  306.    19     Blank
  307.    20-27  Last Use Date
  308.  
  309.  
  310.  
  311.  
  312.  
  313.                                  -3-
  314.  
  315.    28     Blank
  316.    29-93  Comment
  317.  
  318.      The blank columns are ignored by XDIR.  If you should create a 
  319. file with more than 93 characters, the excess characters will simply 
  320. be ignored when XDIR reads the file. Any subsequent edit by XDIR will 
  321. produce a new file with all of the excess characters deleted.
  322.  
  323.    IMPORTANT: If you do edit XDIR.CMT in your own editor, you must be 
  324. sure to sort the entries by columns 1-12 in ascending order.  XDIR 
  325. expects to find a sorted file.
  326.  
  327.      4. Copy mode
  328.  
  329.       XDIR /c [d:]path\filename.ext [d:]path[filename][.ext]
  330.  
  331.      In this mode XDIR copies files in the same manner as the DOS COPY 
  332. command. It also copies the corresponding records (if they exist) from 
  333. XDIR.CMT and inserts them into the file of the same name in the 
  334. destination directory, creating the file if necessary. The * and ? 
  335. wildcard features can be used.
  336.  
  337.      If a file with the same name exists in the destination directory, 
  338. XDIR will ask you before it overwrites the file.
  339.  
  340.      5. Move mode
  341.  
  342.       XDIR /m [d:]path\filename.ext [d:]path[filename][.ext]
  343.  
  344.      This mode is used to MOVE files between directories, or from one 
  345. disk to another. The * and ? wildcard features can be used.  This is a 
  346. feature not provided by DOS. When the two directories are on the same 
  347. disk, the operation is very fast because XDIR changes the DOS 
  348. directory entries and does not to copy the files themselves. When the 
  349. destination directory is located on a different disk, each file is 
  350. first copied to the destination and then deleted from the source 
  351. directory. In any case, the XDIR comment records are transferred 
  352. properly.
  353.  
  354.      If a file to be moved is marked with the Read-Only file 
  355. attribute, and the Move is not between directories on the same disk, 
  356. XDIR will ask you before deleting the file from its source directory. 
  357. Also, if a file with the same name exists in the destination 
  358. directory, XDIR will ask you before it overwrites a file.
  359.  
  360.      This mode can also be used to rename a file. This use is 
  361. identical to the DOS RENAME feature, but it also updates the entry in 
  362. the XDIR.CMT file.
  363.  
  364.                                  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.                                  -4-
  375.  
  376.      6. Kill Mode
  377.  
  378.                    XDIR /k [d:]path\filename.ext
  379.  
  380.      This mode is used to KILL or delete files from the 
  381. directory,similar to the DOS DELETE or ERASE commands. The * and ? 
  382. wildcard features can be used. XDIR displays a directory listing of 
  383. files that satisfy the given filespec and then permits you to PICK 
  384. from these files those that you wish to KILL. This PICK option allows 
  385. you to select an arbitrary group of files for action. The option is 
  386. automatic for the KILL mode but may also be selected for other 
  387. Modes(see Section D.1).  After you have picked the files to be 
  388. deleted, XDIR will ask you for confirmation before actually deleting 
  389. the files.
  390.  
  391.      7. Run Mode
  392.  
  393.      This mode lets you select one or more files from the XDIR display 
  394. and run a suitable program for each file.  There are several different 
  395. options here.  The simplest requires you to specify the program to run 
  396. when you call XDIR.  For example, assuming you have a LIST program, 
  397. then
  398.  
  399.                          XDIR /RLIST *.DOC
  400.  
  401. would display all of the .DOC files in the current directory, let you 
  402. select any of them you wanted, and then LIST each file in turn.
  403.  
  404.      You can specify any executable program you want, and can also 
  405. specify parameters for the program.  For example:
  406.  
  407.                  XDIR /RC:\TP\TPC *.PAS /m /$D+ /V
  408.  
  409.      You can also use /R without a command.  This works as you would 
  410. expect if the files you select are executable EXE, COM or BAT files.  
  411. But you can also set up XDIR to recognize files by extension, and then 
  412. execute an appropriate program.  So, if you use extension .WPD for 
  413. your WordPerfect documents, then you could do this:
  414.  
  415.                            XDIR /R *.WPD
  416.  
  417. Then, simply scan the directory display of WordPerfect documents, 
  418. select the one you want and XDIR will automatically call WordPerfect 
  419. and load the document.
  420.  
  421.      To make this magic work, you must tell XDIR what to do for the 
  422. WPD extension, using a DOS environment variable.  This is really very 
  423. simple.  For this example,
  424. from the DOS prompt you would enter the following:
  425.  
  426.                         SET .WPD=C:\WP51\WP
  427.  
  428.      When you select a WPD file, XDIR knows that DOS will not execute 
  429. it, and looks in the environment for .WPD and incorporates the 
  430. information.  
  431.  
  432.  
  433.  
  434.  
  435.                                  -5-
  436.  
  437.      More complicated commands can easily be implemented.  If your 
  438. program needs Switches or other parameters, just add them to the 
  439. environment variable.  Ordinarily, XDIR will make a command consisting 
  440. of the environment string followed by the selected filename.  If you 
  441. want to insert the selected filename in the middle somewhere, signify 
  442. the place in the environment string with ~S. 
  443.  
  444.      If there is NO matching environment string then XDIR will attempt 
  445. to execute each selected file.  If Filename.ext is an executable file, 
  446. (COM, EXE, BAT), it will be executed.  Otherwise DOS will report an 
  447. error.
  448.  
  449.      For all ways of using the /R option, XDIR will display each 
  450. command line that it constructs at the bottom of the screen before 
  451. attempting to execute it.  You can freely edit the line, correcting 
  452. errors, and adding parameters if you need to.  When you're ready to 
  453. execute the command, just press ENTER.  If you change your mind and 
  454. don't want a command to execute, press ESCape.
  455.  
  456.  
  457.    D. DISPLAY OPTIONS
  458.  
  459.      1. PICK Option 
  460.  
  461.       XDIR /kp [d:]path\filename.ext [d:]path[filename][.ext]
  462.  
  463.      This feature allows you to select an arbitrary group of files for 
  464. action. The option is automatic for the KILL and RUN modes. It may 
  465. also be selected for the COPY or MOVE modes. XDIR displays a directory 
  466. of files that satisfy the given filespec and then permits you to PICK 
  467. from these files those that you want. Move the cursor up and down with 
  468. the cursor keys. You can scroll through the directory with the PgUp, 
  469. PgDn, Ctrl-PgUp and Ctrl-PgDn keys. Ctrl-Home and Ctrl-End move the 
  470. cursor to the top and bottom of the screen. Files can be picked or 
  471. unpicked with successive pressings of the Space Bar. Only the files 
  472. that are picked at the time you press ESC are copied, moved, killed or 
  473. run.
  474.  
  475.      2. Alternative Display Formats
  476.  
  477.      XDIR presents the directory data in four alternative formats; 
  478. examples of each are discussed below.
  479.  
  480.         a. Normal Display
  481.  
  482.                XDIR /n [/Mode] [/any other options]
  483.  
  484.      This display is the same as the DOS DIR display, with 38 
  485. characters of the XDIR comment shown as well. Since many times, 38 
  486. characters is sufficient for a file comment, the whole comment may be 
  487. displayed. If the file comment is longer, as is the case for the entry 
  488. XDIR.EXE, then it is truncated.
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.                                  -6-
  497.  
  498.         b. Full Display
  499.  
  500.    XDIR /f [/Mode] [/Other Options]
  501.  
  502.    XDIR   CMT  Usage Record Beginning 7-15-87
  503.    XDCOUNTEXE  TSR: Monitors/records file openings
  504.    XDIR   EXE  Latest version of XDIR: fixes all known bugs
  505.    XDUPDATEEXE Updates XDIR.CMT with usage data from XDCOUNT data 
  506. files
  507.  
  508.         c. Usage Display
  509.  
  510.                  XDIR /u [/Mode] [/Other Options]
  511.  
  512.      This option causes XDIR to display its information in a slightly 
  513. different format, as shown here:
  514.  
  515.  
  516.    XDIR   CMT   3609 6-07-90  12:11a a  144  6-07-90
  517.    XDCOUNTEXE  12968 6-02-90   3:00a r   28  6-07-90
  518.    XDIR   EXE  29418 6-02-90   3:00a a  245  6-07-90
  519.    XDUPDATEEXE 17824 6-02-90   3:00a a   28  6-07-90
  520.  
  521.      The first four fields are the same as the standard DOS display. 
  522. The next field shows the DOS attributes of each file.  Letters a,h,n,r 
  523. and s are used: 
  524.  
  525.         [a]rchive - a file that has been modified since backup; 
  526.         [h]idden - a file that is intentionally hidden from the DOS 
  527.         DIR display; 
  528.         [n]ormal - any file not a,h,r, or s; 
  529.         [r]ead-only - a file that cannot be deleted by the DOS Delete command; 
  530.         [s]ystem - a special DOS file. 
  531.  
  532.      The number after the attribute field is the number of uses that 
  533. have been recorded for the file. (The comment associated with XDIR.CMT 
  534. always shows the date when recording started for this directory.) The 
  535. date in the last field is the date the file was last used.
  536.  
  537.      The usage display is very helpful when it comes time to prune 
  538. files you really don't need from your hard disk. You can PICK files to 
  539. KILL or MOVE to a floppy disk, while looking at how often you use them 
  540. and your comments.
  541.  
  542.      For instance:
  543.  
  544.                     XDIR /su /kd c:\utils\*.exe
  545.  
  546. will display all of the files with extension EXE, sorted by decreasing 
  547. number of uses, so you can select files to be deleted.  If you want to 
  548. save these files to a floppy disk in drive B command would be:
  549.  
  550.                   XDIR /su /mp c:\utils\*.exe B:
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.                                  -7-
  558.  
  559.         d. Wide Display  
  560.  
  561.                  XDIR /w [/Mode] [/Other Options]
  562.  
  563.      This option causes the directory names to be displayed five to a 
  564. row. No other information is displayed. The display is similar to the 
  565. DOS DIR /w command.
  566.  
  567. XDCOUNT  EXE  XDIR CMT  XDIR EXE  XDIR SRT  XDIRALL   BAT
  568. XDUPDATE COM
  569.  
  570.  
  571.      3. Sort Switch
  572.  
  573. XDIR [/SD] [/SE] [/SL] [/SN] [/SS] [/SU] [/S0] [/mode] [/Other Options]
  574.  
  575.      The XDIR directory display is usually sorted. The sort type is 
  576. determined by adding one of the four sort commands anywhere in the 
  577. command line. /SN is the default.
  578.  
  579.    /SA Directory is sorted by file attributes
  580.  
  581.    /SC Directory is sorted by XDIR comment, in alphabetical order
  582.  
  583.   /SD Directory is sorted by Date and Time, presenting the newest 
  584. file first.
  585.  
  586.    /SE Directory is sorted in increasing alphabetical order, first by 
  587.    Extension, then by File Name.
  588.  
  589.    /SL Directory is sorted by date of last use and then by File Name.
  590.  
  591.    /SN Directory is sorted in increasing alphabetical order by File 
  592.    Name and then by Extension.
  593.  
  594.    /SS Directory is sorted by file size, presenting the largest file 
  595.    first.
  596.  
  597.    /SU Directory is sorted by number of uses, with the most used file 
  598.    presented first.
  599.  
  600.    /S0 Directory is not sorted. The order is the same as presented by 
  601.    the DOS DIR command.
  602.  
  603.  
  604.      4. Quick Write Display Toggle
  605.  
  606.                               XDIR /Q
  607.  
  608.      XDIR ordinarily sends output directly to video memory. This 
  609. provides the quickest screen display and can be used on IBM machines 
  610. and true compatibles. However, this quick write procedure has 
  611. incompatibility problems with some clones and with some software.
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.                                  -8-
  619.  
  620.      If you have any problems with the XDIR screen display, you can 
  621. disable the quick write feature of XDIR with the /Q option.  Users 
  622. with IBM Color Graphics adapters will probably find the display more 
  623. pleasing with this option selected.  See Section E.3 to learn how to 
  624. customize XDIR to automatically use /Q.
  625.  
  626.      5. Display of Hidden Files
  627.  
  628.      DOS allows programs to be marked "Hidden".  These files are not 
  629. shown in the normal DOS DIR display.  XDIR also ignores hidden files 
  630. unless the /h option is selected.  Then, hidden files are displayed 
  631. and can have comments attached, but they can't be copied or moved.
  632.  
  633.  
  634.    E. INSTALLATION  
  635.  
  636.      1. General Use of XDIR
  637.  
  638.    XDIR has been thoroughly tested with DOS 3.0-3.3.  The program will 
  639. work with DOS 2.x but the /m option will not function properly for 
  640. moves between subdirectories on the same disk.
  641.  
  642.    XDIR should be available to you all the time. If you have a hard 
  643. disk, make sure that XDIR is located in a directory in the current 
  644. path. The easiest installation is as follows (assuming that the XDIR 
  645. files are in Drive A:)
  646.  
  647.           C:\
  648.           A:XDIR /c A:*.*
  649.  
  650.    Also make sure your autoexec.bat file contains a line with
  651.  
  652.           PATH=C:\;
  653.  
  654.    If you don't have a hard disk, best use of XDIR is obtained if you 
  655. load it on to a Ramdisk and then PATH the Ramdisk.
  656.  
  657.      2. Conversion from Previous Versions of XDIR
  658.  
  659.    If you have a version of XDIR earlier than Version 2.02, you will 
  660. need to convert your XDIR.CMT files to a new format.  The program 
  661. XDCNVRT.EXE is provided for this purpose. To use XDCNVRT, the 
  662. following steps are required:
  663.  
  664.         a. Set the current drive and path to the directory containing 
  665. XDCNVRT. Typically this would involve:
  666.  
  667.           >CD A:\
  668.           >A:
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.                                  -9-
  680.  
  681.         b. Execute XDCNVRT, specifying the drive to be worked on.  
  682. XDCNVRT will automatically convert all XDIR.CMT files on that drive.  
  683. You must carry out this step on all disks that have XDIR.CMT files.  
  684. For example:
  685.  
  686.           XDCNVRT C:
  687.  
  688.  
  689.      3. Customizing XDIR Features
  690.  
  691.    The actions to be taken by XDIR are all specified from the command 
  692. line. Several default options have been set under the assumption that 
  693. they are the ones you will use most often. As a result, the following 
  694. are equivalent commands:
  695.  
  696.           XDIR
  697.  
  698.           XDIR /d /n /sn *.*
  699.  
  700.    If you find that you prefer other command line default entries, you 
  701. can set them using the DOS Environment SET feature.  SET is a DOS 
  702. command that you can execute from the > prompt. For example, if you 
  703. normally prefer to see the display sorted by extension, and do not 
  704. want the Quick write feature, these can be made defaults as follows:
  705.  
  706.           SET XDIR=/se /q
  707.  
  708.    You can remove any options that you have SET with the following DOS 
  709. command:
  710.  
  711.           SET XDIR=
  712.  
  713.    When you are sure of the defaults that you want, it's convenient to 
  714. put your SET command into your AUTOEXEC.BAT file.
  715.  
  716.  
  717.    F. ADDITIONAL UTILITIES FOR USE WITH XDIR
  718.  
  719.      Registered users of XDIR receive several utilities designed to 
  720. enhance its use.  These utilities are described in this section.
  721.  
  722.      1. File Use Monitoring with XDCOUNT and XDUPDATE
  723.  
  724.    This feature is implemented only for hard disks. Usage on floppies 
  725. or RAM Disks is not recorded, and is simply ignored by the system.
  726.  
  727.         a. Installing XDCOUNT
  728.  
  729.    File use monitoring is implemented in two steps. The program 
  730. XDCOUNT.EXE is a resident module that goes into action whenever one of 
  731. your programs is executed or a data file opened for use. XDCOUNT 
  732. registers these events and writes the usage data to the file XDIR.DTA 
  733. for later use. The program XDUPDATE.EXE must be called periodically to 
  734. transfer this use data to the appropriate XDIR.CMT files.  You can set 
  735. up XDCOUNT to call XDUPDATE automatically if you wish.
  736.  
  737.  
  738.  
  739.  
  740.                                  -10-
  741.  
  742.    XDCOUNT has two command line options:
  743.  
  744.                     XDCOUNT [nnn] [Drive ...] 
  745.  
  746.      The [nnn] XDCOUNT option provides for automatic execution of 
  747. XDUPDATE (see below).
  748.  
  749.      If you have more than one hard disk, you can specify which ones you 
  750. want XDCount to watch.  If you don't specify a drive, XDCOUNT will 
  751. ignore activity on that drive. Be sure to specify only HARD drives. If 
  752. you do not specify any drive letters, drive C is assumed.  The best 
  753. way to install XDCOUNT is to place it in your Autoexec.bat file.  
  754. XDCount will record usage of all files called after it.  So remember, 
  755. that commands in your autoexec file before XDCOUNT will not be 
  756. recorded.
  757.  
  758.    Conflicts have been reported between previous versions of XDCOUNT 
  759. and other resident software (TSRs).  These have  all been cured.  The 
  760. new version is very robust.  You should find it quite accommodating to 
  761. the various other TSRs you use.  Nevertheless, there is always some 
  762. possibility of undesirable interactions among resident programs.  In 
  763. the unlikely event that you experience any difficulty, experiment with 
  764. moving the location of XDCOUNT forward in the autoexec file, after 
  765. other TSRs.  If this doesn't work, experiment with removing all other 
  766. TSRs and then restoring them one by one until the conflicting software 
  767. is found.  If you find any conflicts, please let us know the details, 
  768. including your hardware configuration, and the contents of your 
  769. autoexec.bat and config.sys files.
  770.  
  771.      The second XDCOUNT option provides for automatic execution of 
  772. XDUPDATE (see below).
  773.  
  774.         b. Use of XDUPDATE
  775.  
  776.      XDUPDATE transfers file usage data from the temporary XDIR.DTA 
  777. file that XDCOUNT creates to the XDIR.CMT files located in each 
  778. subdirectory.  When done, it deletes XDIR.DTA.  You can run XDUPDATE 
  779. whenever you want, as a minimum, once a day.  However, it may take 
  780. several minutes if you have had a lot of file usage since the last 
  781. time.  You can call XDUPDATE in your autoexec file, to make sure it is 
  782. run every time your PC is started up.  Alternatively, you can arrange 
  783. to have XDUPDATE run automatically whenever you are away from the 
  784. keyboard and the machine is idling at the DOS prompt.  To do this, 
  785. specify how many minutes you want your system to be at the DOS prompt 
  786. before XDUPDATE is automatically invoked.  If you are often away from 
  787. your machine for extended periods of time, XDUPDATE will be run in 
  788. your absence, and you'll never have to worry about it.  Be sure to 
  789. include the subdirectory containing XDUPDATE.EXE in your DOS PATH 
  790. specification.
  791.  
  792.      For example, if you want to wait 15 minutes before starting 
  793. XDUPDATE:
  794.  
  795.  
  796.                           XDCOUNT 15 c d 
  797.  
  798.  
  799.  
  800.                                  -11-
  801.  
  802.         c. Use of XDUPDATE to Clear Usage Data
  803.  
  804.    Occasionally, it is useful to CLEAR the usage data in a directory, 
  805. or group of directories to zero. You can do this for a single 
  806. directory by making it the Current Directory and then executing 
  807. XDUPDATE /C .
  808.  
  809.           ChangeDir C:\memos
  810.           XDUPDATE /C
  811.  
  812.    If you wish to clear a directory and all of its Subdirectories, use 
  813. XDUPDATE /S. For example, to clear all of the usage data on your hard 
  814. disk:
  815.  
  816.           ChangeDir C:\
  817.           XDUPDATE /S
  818.  
  819.      2. XDZIP and XDUNZIP 
  820.  
  821.    XDIR provides a way of attaching descriptions to files on your disk 
  822. that is apparently seamless.  The descriptions appear on directory 
  823. displays and automatically are copied when you COPY or MOVE a file to 
  824. another disk or directory.
  825.  
  826.    But this seamless property fails as soon as you use other programs 
  827. on your files.  For example, if you archive the files with the PKware 
  828. programs PKZIP or PKUNZIP, the descriptions stay behind.  XDZIP and 
  829. XDUNZIP address this problem, providing an automatic method to store 
  830. descriptions in ZIPFiles and to restore them when you extract a file.
  831.  
  832.    You must have copies of the PKware utilities located on the DOS 
  833. Path, or in the current directory.  These shareware programs are not 
  834. supplied with XDZIP/XDUNZIP.  You can obtain them from many Shareware 
  835. distributors, BBS's or from PKware directly at:
  836.  
  837.         PKware Inc.
  838.         7545 North Port Washington Road
  839.         Glendale, WI 53217
  840.  
  841. PKZIP and PKUNZIP are trademarks of PKware.  XD Systems is not 
  842. affiliated with PKware in any way.
  843.  
  844.         a.  XDZIP USAGE
  845.  
  846.    XDZIP Usage is:
  847.  
  848.         XDZIP ZIPFILE [/am?] [d:][path][filespec] [+filespec] [+..]
  849.  
  850.      A directory display similar to XDIR's will appear showing all of 
  851. the files meeting any of the filespecs. You can specify several 
  852. different file groupings, each with DOS wildcards.  Note that only the 
  853. first one in the list can have a pathname; subsequent arguments 
  854. default to the same path.
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.                                  -12-
  862.  
  863.      You can mark files to be ZIPped into ZipFile in several ways, 
  864. similar to the XDIR SELECT command, as follows:
  865.  
  866.         <+>    MARK file
  867.         <->    UNMARK file
  868.         <space>   Toggle MARK
  869.         <*>    MARK all files
  870.                          
  871.    To move the selection bar around the list of files, use the 
  872. following keys:
  873.  
  874.         <UP>   Move up one line
  875.         <DOWN>    Move down one line
  876.         <PgUp> Move up one full screen
  877.         <PgDn>    Move down one full screen
  878.         <HOME>    Move to top of list
  879.         <END>  Move to end of list
  880.  
  881.      When you are finished marking files, then:
  882.  
  883.         <ENTER>   ZIP marked files into ZIPFILE
  884.         <Esc>  Quit XDZIP without doing anything
  885.  
  886.      XDZIP also has two options, which can be used singly or together, 
  887. e.g., /a /m, or /am.
  888.  
  889.      /a  ZIP all files matching filespecs without query.
  890.  
  891.      So, for example
  892.  
  893.             XDZIP Junk /a  C:\SOURCE\*.Pas + *MATH*.INC
  894.  
  895. would ZIP into JUNK.ZIP all files from the C:\SOURCE directory that 
  896. either had the extension PAS or the extension INC and MATH anywhere in 
  897. the filename.
  898.   
  899.      /m  Move selected files from source directory to the ZIPFile.
  900.  
  901.    This works by deleting the files from the source directory after 
  902.    ZIPping.
  903.             
  904.         b. XDUNZIP USAGE
  905.  
  906.      XDUNZIP Usage is:
  907.  
  908. XDUNZIP ZIPFILE [/adm?] [outpath] [d:][path][filespec] [+filespec] [+..]
  909.  
  910.      The display is identical to the XDZIP display, showing  all the 
  911. files in the ZipFile that meet any of the filespecs.  Marking of the 
  912. files to be extracted and cursor movement  around the screen is 
  913. identical to XDZIP.
  914.  
  915.      XDUNZIP has three options.  The first two are similar to the ones 
  916. provided for XDZIP.
  917.  
  918.  
  919.  
  920.  
  921.  
  922.                                  -13-
  923.  
  924.      /a  UNZIP all files matching filespecs without query.  
  925.  
  926.      /m  Move selected files from the ZIPFile to the outpath directory 
  927.      (Current directory is default).
  928.  
  929.      /d  Delete selected files from the ZIPFile without extracting.
  930.  
  931.      This provides a convenient tool for ZipFile management, allowing 
  932. you to select files to be removed using any combination of filespecs 
  933. with wild cards and the SELECT screen.  The combination /ad will 
  934. delete all the specified files  without presenting the SELECT screen.  
  935. The combination /md is interpreted the same as /m alone.
  936.   
  937.      Outpath, if supplied, determines the directory in which the 
  938. extracted files are to be placed.  So for example:
  939.  
  940.                   XDUNZIP C:\SOURCE\JUNK A:\ /am *.doc
  941.  
  942. would extract all of the files with extension doc from the file 
  943. C:\SOURCE\JUNK.ZIP and place them in the root directory of the A: 
  944. drive.  Then it would delete all of these files  from JUNK.ZIP.
  945.  
  946.  
  947.     G. FILES SUPPLIED
  948.  
  949.    The files supplied with the shareware version of XDIR are:
  950.  
  951.    XDC.BAT        Equivalent to XDIR /c -- Copies files
  952.    XDE.BAT        Equivalent to XDIR /e -- Edit file comments
  953.    XDM.BAT        Equivalent to XDIR /m -- Move files between 
  954. directories 
  955.    XDIR.DOC       To print enter: TYPE XDIR.DOC > prn
  956.    XDIR.EXE       Latest version of XDIR: fixes all known bugs.  
  957.    XDCNVRT.EXE    Convert older XDIR.CMT files to version 3.0 format
  958.  
  959.    The three batch files are provided for your convenience.  It's 
  960. easier to use them than typing XDIR /xx. You are free to rename these 
  961. files if you wish. If you use an extended DOS editor like DOSEDIT or 
  962. CED, you will find it most convenient to replace these batch files 
  963. with synonym commands.
  964.  
  965.      Additional files provided to registered users are:
  966.  
  967.    XDCOUNT.EXE    TSR: Monitors/records file openings
  968.    XDUPDATE.EXE   Updates XDIR.CMT with usage data from XDCOUNT data 
  969. files
  970.    XDZIP.EXE      ZIP files, automatically including XDIR Comments
  971.     XDUNZIP.EXE   UNZIP files, and restore stored comments to XDIR
  972.  
  973. These files are not shareware and may not be distributed.
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.                                  -14-
  984.  
  985.    H. ASSOCIATION OF SHAREWARE PROFESSIONALS
  986.  
  987.      The author of this program is a member of the Association of 
  988. Shareware Professionals (ASP), an organization formed in April 1987 to 
  989. strengthen the future of shareware (user-supported software) as an 
  990. alternative to commercial software.  Its members, all of whom are 
  991. programmers who subscribe to a code of ethics, are committed to the 
  992. concept of shareware as a method of marketing.
  993.  
  994.      ASP has established stringent standards for its members.  ASP 
  995. wants to make sure that the shareware principle works for you.  If you 
  996. are unable to resolve a problem with an ASP member (other than 
  997. technical support), ASP may be able to help.  Please write to the ASP 
  998. Ombudsman at P.O. Box 5786, Bellevue, WA 98006.
  999.  
  1000.      The primary goals of the ASP are:
  1001.         To inform users about shareware programs and about shareware 
  1002.         as a method of distributing and marketing software;
  1003.         To encourage broader distribution of shareware through user 
  1004.         groups and disk dealers who agree to identify and explain the 
  1005.         nature of shareware;
  1006.         To assist members in marketing their software;
  1007.         To provide a forum through which ASP members may communicate, 
  1008.         share ideas, and learn from each other; and
  1009.         To foster a high degree of professionalism among shareware 
  1010.         authors by setting programming, marketing, and support 
  1011.         standards for ASP members to follow.
  1012.  
  1013.  
  1014.             Standards for the Association of Shareware Professionals
  1015.  
  1016.    PROGRAMMING STANDARDS:
  1017.  
  1018.    The program meets the ASP's definition of "shareware" (i.e., it is 
  1019.    not a commercial demo with major feature disabled, nor a time- 
  1020.    limited program).
  1021.  
  1022.    The program has been thoroughly tested by the author and should not 
  1023.    be harmful to other files or hardware if used properly.
  1024.    DOCUMENTATION STANDARDS:
  1025.  
  1026.    Sufficient documentation is provided to allow the average user to 
  1027.    try all the major functions of the program.
  1028.  
  1029.    Any discussion of the shareware concept and of registration 
  1030.    requirements is done in a professional and positive manner.
  1031.  
  1032.    SUPPORT STANDARDS:
  1033.  
  1034.    The member will respond to people who send registration payments, 
  1035.    as promised in the program's documentation.  At a minimum, the 
  1036.    member will acknowledge receipt of all payments.
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.                                  -15-
  1045.  
  1046.    I. XDIR VERSION HISTORY
  1047.  
  1048.    Ver. 1.001/25/87
  1049.    First release, withdrawn immediately because F10 function key did 
  1050.    not work at all.
  1051.  
  1052.    Ver. 1.0101/26/87
  1053.    Corrected F10 problem but 'D' entered in a comment field caused 
  1054.    action identical to F10
  1055.  
  1056.    Ver. 1.0201/27/87
  1057.    Fixed the F10 problem correctly.
  1058.  
  1059.    Ver. 1.0301/29/87
  1060.    Fixed problem with Copy to current directory. Now can call:  XDIR 
  1061.    /c C:\xxx.yyy Previously required XDIR /c C:\xxx.yyy C:  
  1062.    Fixed a problem with recognizing directory names.  Previously XDIR 
  1063.    interpreted C:\XXX as equivalent to C:XXX.* This is incorrect when 
  1064.    XXX is a directory name.
  1065.    Fixed a problem with deleting Comment entries. Now Del, BSP or fill 
  1066.    with blanks works OK.
  1067.    Add listing of file names moved, same as DOS copy.  
  1068.    Extend allowable number of files in a directory to 256.  
  1069.    Extend allowable number of files moved to 128.  
  1070.    Speed up XDIR by using Quiksort routine.
  1071.  
  1072.    Ver. 1.0402/22/87
  1073.    General Cleanup: Reduced size and improved speed.
  1074.    Removed undocumented restriction of previous versions, which could 
  1075.    not copy or move a file larger than 38K.
  1076.    Added Sorted directory display with Name, Ext, Date and Size 
  1077. options.
  1078.  
  1079.    Ver. 2.01 12/01/87
  1080.    Added Pick feature.
  1081.    Added Alt-Del feature to edit option.
  1082.    Modified access to XDIR.CMT to permit XDIR /d use on networks.
  1083.    Reduced overall size with Turbo Optimizer (Reg. Turbo Power 
  1084.    Software).
  1085.    Automatically go to PICK mode if no filespec is provided with /m or 
  1086.    /c
  1087.    Add the /k mode to delete files
  1088.    Add the /w mode to provide wide display, 5 files per line 
  1089.    Add usage count for files, both executable and data 
  1090.    Add an Unsorted directory option: /S0
  1091.    Fix problem with screen color changes. Previously left yellow text 
  1092.    on black background. Change to leave colors unchanged.
  1093.  
  1094.    Ver. 2.023/15/88
  1095.    This Version of XDIR has been substantially rewritten. It is the 
  1096.    first version to use Turbo Pascal 4.0 and incorporates a number of 
  1097.    new features.
  1098.  
  1099.    Comment field increased to 65 characters from 38.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.                                  -16-
  1106.  
  1107.    Scroll up and down through directory display.  
  1108.    Number of directory elements increased to 1024.
  1109.    Number of files that can be copied or moved in one command is 1024
  1110.    Directory now shows file attributes.
  1111.    Sort on comment field is included.
  1112.    Average comment file size is decreased.
  1113.    XDCNVRT.EXE is provided to change from earlier versions.  
  1114.    Memory requirements have been decreased.
  1115.    Operation is noticeably faster.
  1116.    Compatibility with Keyboard enhancers has been improved.  
  1117.    Comments can be attached to directories.
  1118.    Quick writing can be toggled off for improved compatibility.  
  1119.    XDIR defaults can be altered using the DOS SET command.
  1120.  
  1121.     Ver. 3.0   6/10/90 
  1122.     XDCount rewritten for improved compatibility with other TSRs.  
  1123.    Formerly, XDCount placed its XDIR.DTA file in the C: root 
  1124.    directory. But Drive C is not always a hard disk.  Now it puts the 
  1125.    file in the root of the first drive specified on the command line.  
  1126.    Automatic scheduling of XDUPDATE execution added.
  1127.  
  1128.    XDUPDATE was rewritten to search all hard disk root directories for 
  1129.    XDIR.DTA and processes them all.
  1130.  
  1131.    XDIR Run option added.
  1132.  
  1133.    All .EXE files compressed with LZEXE     
  1134.  
  1135.    Version 3.01  7-31-90
  1136.    /R Mode bugs
  1137.    1.  XDIR expands a source file spec that has no '.' by adding '.*'        
  1138.        This was not being done for the 'R' Mode.
  1139.    2.  Both XDIR Options and parameters for the program to be run can
  1140.        now be placed on the command line.  Previously, the following
  1141.        would be parsed incorrectly:
  1142.  
  1143.           XDIR /F /R *.exe -R32 /k -aload
  1144.  
  1145.        Now, all parameters before the file spec (*.exe) are
  1146.       interpreted as applying to XDIR, and the others are applied
  1147.       to the executable program.
  1148.  
  1149.   3.  Corrected error in this manual (p. 5).  The filename place
  1150.       holder is ~S, not %1.
  1151.  
  1152.   Error handling improved for Drive not ready and Disk write-protected.
  1153.  
  1154.   XDZIP and XDUNZIP had bugs that could lose descriptions; now fixed.
  1155.  
  1156.   Version 3.02   9/16/90
  1157.   XDUNZIP choked on the long ZipFile comments now being added by some
  1158.   BBS operators.  Modified to correct this.
  1159.  
  1160.  
  1161.                                -17-
  1162.  
  1163.                   SOFTWARE REGISTRATION FORM AND ORDER
  1164.  
  1165.  
  1166.  
  1167.  Check all that apply:                                    
  1168.  
  1169.    [ ] XDIR registration                   _____ @ $25.00    
  1170.  
  1171.        TOTAL ENCLOSED: $______
  1172.  
  1173.  
  1174.              If you already have copies of the programs you are
  1175.         ordering , where were they obtained?
  1176.  
  1177.     [ ]CompuServe [ ]Friend [ ]Employer [ ]BBS ______________________
  1178.  
  1179.     [ ]Shareware Distributor ________________________________________
  1180.  
  1181.  
  1182.   Payment is by check[ ] or money order[ ] (Sorry - no COD or charges)
  1183.  
  1184.  
  1185.  
  1186.         NAME    ___________________________________________
  1187.  
  1188.         COMPANY ___________________________________________
  1189.  
  1190.         ADDRESS ___________________________________________
  1191.  
  1192.         CITY    ___________________________________________
  1193.  
  1194.         STATE   __________________________ZIP _____________
  1195.  
  1196.  
  1197.  
  1198.         Send your registration form and payment to:
  1199.  
  1200.                        XD Systems
  1201.                        1014 Shipman Lane
  1202.                        McLean, VA 22101
  1203.  
  1204.  
  1205.